Scenario #6010: Replace Deceased Partner by Community of Heirs

Properties

Required

Given

name value
partnerNumber P-31011
dateOfDeath 2024-11-15
representativeGivenName Lena
representativeFamilyName Stadland
communityOfHeirsPostalAddress “street”: “Im Wischer 14”,
“zipcode”: “22987”,
“city”: “Hamburg”,
“country”: “Germany”
communityOfHeirsOfficePhoneNumber +49 40 666666
communityOfHeirsEmailAddress lena.stadland@example.org

Partner: P-31011

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "7d1e5750-8a7a-46cd-8475-29a568d25ded", // Partner: P-31011 - Michelle Matthieu
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "c0f43b0d-472a-45b3-9f6b-969c728b683b",
    "anchor" : {
      "uuid" : "882bda1d-4e5e-42f8-afdd-b9741d1c1f4e", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "53869a92-66f1-4e83-9850-80f2a708f39f", // personUuid
      "personType" : "NATURAL_PERSON",
      "tradeName" : null,
      "salutation" : null,
      "title" : null,
      "givenName" : "Michelle",
      "familyName" : "Matthieu-Zhang"
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "8c06e07a-89e5-4b36-8049-09d785e2d47d", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "details" : {
    "uuid" : "18c9e468-87a8-4e62-b3d7-b59aa8973083",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Even in production data we expect this query to return just a single result.

New Partner-Person+Contact: Erbengemeinschaft Michelle Matthieu-Zhang

HTTP PATCH "/api/hs/office/partners/7d1e5750-8a7a-46cd-8475-29a568d25ded" // Partner: P-31011 \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "partnerRel" : {
    "holder" : {
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang"
    },
    "contact" : {
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "whatever" : "any key is allowed here",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "street" : "Im Wischer 14",
        "zipcode" : "22987",
        "city" : "Hamburg",
        "country" : "Germany"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      }
    }
  }
}
EOF
=> status: 200 OK 
{
  "uuid" : "7d1e5750-8a7a-46cd-8475-29a568d25ded", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "c0f43b0d-472a-45b3-9f6b-969c728b683b",
    "anchor" : {
      "uuid" : "882bda1d-4e5e-42f8-afdd-b9741d1c1f4e", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20",
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8",
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "18c9e468-87a8-4e62-b3d7-b59aa8973083",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang

HTTP POST "/api/hs/office/relations" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "type" : "REPRESENTATIVE",
  "anchor.uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
  "holder" : {
    "personType" : "NATURAL_PERSON",
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "contact.uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8" // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
}
EOF
=> status: 201 CREATED 6341e77a-3950-4bfe-abb9-57c2956bc84b
{
  "uuid" : "6341e77a-3950-4bfe-abb9-57c2956bc84b",
  "anchor" : {
    "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "89031ebf-a02b-445c-b204-c76aa33e106a",
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
}

Verify the Updated Partner

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "7d1e5750-8a7a-46cd-8475-29a568d25ded", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "c0f43b0d-472a-45b3-9f6b-969c728b683b",
    "anchor" : {
      "uuid" : "882bda1d-4e5e-42f8-afdd-b9741d1c1f4e", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "18c9e468-87a8-4e62-b3d7-b59aa8973083",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Verify the Ex-Partner-Relation

HTTP GET "/api/hs/office/relations?relationType=EX_PARTNER&personUuid=53869a92-66f1-4e83-9850-80f2a708f39f" // Person: Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "264230cd-535f-413d-afd6-808da85518b0",
  "anchor" : {
    "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "53869a92-66f1-4e83-9850-80f2a708f39f", // Person: Michelle Matthieu-Zhang
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Michelle",
    "familyName" : "Matthieu-Zhang"
  },
  "type" : "EX_PARTNER",
  "mark" : null,
  "contact" : {
    "uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Representative-Relation

HTTP GET "/api/hs/office/relations?relationType=REPRESENTATIVE&personUuid=d47cde4a-5da1-445b-a6f8-1676afd57f20" // Person: Erbengemeinschaft Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "6341e77a-3950-4bfe-abb9-57c2956bc84b", // Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang
  "anchor" : {
    "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "89031ebf-a02b-445c-b204-c76aa33e106a", // Person: Lena Stadland
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Debitor-Relation

HTTP GET "/api/hs/office/debitors?partnerNumber=P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "7c76e045-4a03-471a-ac50-4a3b255824be", // Debitor: D-3101100 - Michelle Matthieu
  "debitorRel" : {
    "uuid" : "e8bbeec9-8bd7-4ed4-b065-2fd117ac62cd",
    "anchor" : {
      "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "DEBITOR",
    "mark" : null,
    "contact" : {
      "uuid" : "8c06e07a-89e5-4b36-8049-09d785e2d47d", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "debitorNumber" : "D-3101100",
  "debitorNumberSuffix" : "00",
  "partner" : {
    "uuid" : "7d1e5750-8a7a-46cd-8475-29a568d25ded", // Partner: P-31011
    "partnerNumber" : "P-31011",
    "partnerRel" : {
      "uuid" : "c0f43b0d-472a-45b3-9f6b-969c728b683b",
      "anchor" : {
        "uuid" : "882bda1d-4e5e-42f8-afdd-b9741d1c1f4e", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "d47cde4a-5da1-445b-a6f8-1676afd57f20", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
        "personType" : "UNINCORPORATED_FIRM",
        "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "13ad3db6-f2ac-4ed3-9a2f-fa7b425032b8", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
        "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "postalAddress" : {
          "zipcode" : "22987",
          "country" : "Germany",
          "city" : "Hamburg",
          "street" : "Im Wischer 14",
          "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
          "co" : "Lena Stadland",
          "whatever" : "any key is allowed here"
        },
        "emailAddresses" : {
          "main" : "lena.stadland@example.org"
        },
        "phoneNumbers" : {
          "office" : "+49 40 666666"
        }
      }
    },
    "details" : {
      "uuid" : "18c9e468-87a8-4e62-b3d7-b59aa8973083",
      "registrationOffice" : null,
      "registrationNumber" : null,
      "birthName" : "Eichbaum",
      "birthPlace" : "Neustadt a.d.R.",
      "birthday" : "1951-03-25",
      "dateOfDeath" : null
    }
  },
  "billable" : true,
  "vatId" : null,
  "vatCountryCode" : null,
  "vatBusiness" : false,
  "vatReverseCharge" : false,
  "refundBankAccount" : null,
  "defaultPrefix" : "mim"
} ]

generated on 2026-08-10 04:34:25 for branch HEAD